home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3p / pthread_join.z / pthread_join
Encoding:
Text File  |  1998-10-20  |  2.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. pppptttthhhhrrrreeeeaaaadddd____jjjjooooiiiinnnn((((3333PPPP))))                                              pppptttthhhhrrrreeeeaaaadddd____jjjjooooiiiinnnn((((3333PPPP))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pthread_join - wait for thread termination
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<pppptttthhhhrrrreeeeaaaadddd....hhhh>>>>
  13.  
  14.      iiiinnnntttt pppptttthhhhrrrreeeeaaaadddd____jjjjooooiiiinnnn((((pppptttthhhhrrrreeeeaaaadddd____tttt tttthhhhrrrreeeeaaaadddd,,,, vvvvooooiiiidddd ********rrrreeeettttvvvvaaaallll))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _p_t_h_r_e_a_d__j_o_i_n() function waits for the thread identified by _t_h_r_e_a_d to
  18.      terminate.  If _r_e_t_v_a_l is not zero, then it will be set to the exit value
  19.      of the thread [see _p_t_h_r_e_a_d__e_x_i_t(), _p_t_h_r_e_a_d__c_a_n_c_e_l()].  Only one thread
  20.      may wait for another at one time.
  21.  
  22.      A detached thread [see _p_t_h_r_e_a_d__d_e_t_a_c_h()] may not be joined.  A successful
  23.      join will automatically detach the target thread.  However,
  24.      _p_t_h_r_e_a_d__j_o_i_n() is a cancellation point and if the joiner is cancelled,
  25.      the target thread remains undetached and can be the target of another
  26.      _p_t_h_r_e_a_d__j_o_i_n().  If a thread becomes detached after another thread is
  27.      waiting for it, the waiting thread is awoken and returns an error.
  28.  
  29. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  30.      On success _p_t_h_r_e_a_d__j_o_i_n() returns zero; otherwise an error number is
  31.      returned:
  32.  
  33.      [[[[EEEESSSSRRRRCCCCHHHH]]]]        The _t_h_r_e_a_d parameter does not identify a thread.
  34.  
  35.      [[[[EEEEIIIINNNNVVVVAAAALLLL]]]]       The thread identified by _t_h_r_e_a_d is not joinable (it is
  36.                     detached).
  37.  
  38.      [[[[EEEEDDDDEEEEAAAADDDDLLLLKKKK]]]]      The thread identified by _t_h_r_e_a_d is the calling thread.
  39.  
  40. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  41.      pthread_exit(3P), pthread_cancel(3P), pthread_detach(3P).
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.